package com.szgz.platform.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.szgz.platform.model.TaskStepTemplate;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 任务步骤模板Mapper接口
 */
@Mapper
public interface TaskStepTemplateMapper extends BaseMapper<TaskStepTemplate> {

    /**
     * 分页查询步骤模板
     *
     * @param page 分页参数
     * @param templateType 模板类型（可选）
     * @param stepType 步骤类型（可选）
     * @param isPublic 是否公开（可选）
     * @param status 状态（可选）
     * @return 分页结果
     */
    IPage<TaskStepTemplate> selectTemplates(Page<TaskStepTemplate> page,
                                          @Param("templateType") String templateType,
                                          @Param("stepType") String stepType,
                                          @Param("isPublic") Boolean isPublic,
                                          @Param("status") String status);

    /**
     * 查询指定类型的步骤模板
     *
     * @param templateType 模板类型
     * @param stepType 步骤类型
     * @param isPublic 是否公开
     * @return 模板列表
     */
    List<TaskStepTemplate> selectTemplatesByType(@Param("templateType") String templateType,
                                               @Param("stepType") String stepType,
                                               @Param("isPublic") Boolean isPublic);

    /**
     * 查询公开的步骤模板
     *
     * @param templateType 模板类型（可选）
     * @param stepType 步骤类型（可选）
     * @return 公开模板列表
     */
    List<TaskStepTemplate> selectPublicTemplates(@Param("templateType") String templateType,
                                               @Param("stepType") String stepType);

    /**
     * 查询用户创建的步骤模板
     *
     * @param createdBy 创建者ID
     * @param status 状态（可选）
     * @return 用户创建的模板列表
     */
    List<TaskStepTemplate> selectUserTemplates(@Param("createdBy") Long createdBy,
                                             @Param("status") String status);

    /**
     * 根据模板名称查询模板
     *
     * @param templateName 模板名称
     * @return 模板
     */
    TaskStepTemplate selectByTemplateName(@Param("templateName") String templateName);

    /**
     * 增加模板使用次数
     *
     * @param templateId 模板ID
     * @return 影响行数
     */
    int incrementUsageCount(@Param("templateId") Long templateId);

    /**
     * 查询热门模板（按使用次数排序）
     *
     * @param limit 限制数量
     * @param isPublic 是否公开
     * @return 热门模板列表
     */
    List<TaskStepTemplate> selectPopularTemplates(@Param("limit") Integer limit,
                                                @Param("isPublic") Boolean isPublic);

    /**
     * 查询相似模板
     *
     * @param templateType 模板类型
     * @param stepType 步骤类型
     * @param excludeId 排除的模板ID
     * @param limit 限制数量
     * @return 相似模板列表
     */
    List<TaskStepTemplate> selectSimilarTemplates(@Param("templateType") String templateType,
                                                @Param("stepType") String stepType,
                                                @Param("excludeId") Long excludeId,
                                                @Param("limit") Integer limit);

    /**
     * 统计模板数量
     *
     * @param templateType 模板类型（可选）
     * @param stepType 步骤类型（可选）
     * @param isPublic 是否公开（可选）
     * @return 模板数量
     */
    int countTemplates(@Param("templateType") String templateType,
                      @Param("stepType") String stepType,
                      @Param("isPublic") Boolean isPublic);

    /**
     * 批量更新模板状态
     *
     * @param templateIds 模板ID列表
     * @param status 新状态
     * @return 影响行数
     */
    int batchUpdateStatus(@Param("templateIds") List<Long> templateIds,
                         @Param("status") String status);
} 